My Simple Shaman (WoW Forever 1.60.1용)

Game Version: WoW Forever 1.60.1 (Interface 16001) Version: 1.0.0
(2026. 11. 8.)

───────────────────────────── 
1. 애드온 개요
───────────────────────────── 
■ My Simple Shaman은 토템과 주요 스킬 및 버프 상태를 한눈에 파악하고 효율적으로 관리하도록 순수 Lua로 가볍게 작성된 주술사 전용 애드온입니다.

■ 현재 접속한 캐릭터가 주술사일 때만 활성화되며, 토템 설치 자동화 매크로 생성, 속성별 토템 설정, 토템 버프 대상 추적, 각종 보호막 및 무기 강화 상태 추적, 버프 발동이나 쿨다운 및 지속시간에 대한 개인 채팅 알림을
제공합니다. (경보음 선택 가능)

■ WoW Classic 1.15.8 및 TBC 2.5.6용 기존 버전을 바탕으로 WoW Forever
1.60.1의 최신 본섭 계열 UI/API 구조에 맞게 수정한 버전입니다. 전투 로그에 기반했던 본인 디버프, 마법흡수, 차단, 아군 해제, 적군 정화에 대한 공개 채팅 기능은 삭제했습니다.

───────────────────────────── 
2. 주요 기능 ─────────────────────────────
■ 토템 및 무기 버프
- 속성별 버튼: 대지, 불, 물, 바람 순서의 4개 버튼과 주무기/보조무기 버프 버튼까지 총 6개의 버튼으로 구성됩니다.
- 개별 플라이아웃 버튼: 버튼 마우스오버 시에 시전 가능한 최대 레벨의 토템/버프 목록이 나타납니다.
- Shift+우클릭: 1번부터 4번 버튼까지 해당 속성 토템을 공백으로 설정합니다.
- 좌클릭/우클릭: 설정된 토템을 개별적으로
설치하거나 해당 무기에 버프를 부여합니다.
- 토템 버프 대상: 내 토템의 영향을 받고 있는 파티원들을 토템 버튼 상단에 직업명 한글 약자 또는 네모로 직업 고유 색상을 입혀서 표시합니다. 내가 토템에서 멀어져서 버프가
없어질 때는 해당 토템 버튼에 빨간색 테두리를 표시합니다.
- 비설정 토템 아이콘: 버튼에 설정되지 않은 토템을 설치하면 버튼 아이콘이 회색으로
변하며, 현재 설치된 토템의 아이콘을 '토템 버프 대상'의 위에 표시합니다.
- 무기 버프 버튼에 표시되는 지속시간은 오일도 포함합니다.
- Forever의 최신 주문/Aura API 구조에 맞춰 스킬, 버프, 토템 상태를 확인합니다.

■ 자동 매크로 생성(MSS / MSSC)
- 4개 속성의 토템을 일반 세트로 설정하면
캐릭터 공용 매크로 탭에 'MSS'라는 이름의 매크로를 자동으로 생성/갱신합니다.
- 일반 토템 세트의 MSS 매크로는 기존과
같이'/castsequence' 형식으로 설정된 토템을 순서대로 설치합니다.
- Shift+우클릭으로 공백 설정한 속성의 토템은 MSS에 포함하지 않습니다.
- Forever에 추가된 원소의 부름, 선조의 부름, 영혼의 부름을 위한 고정 토템 세트 이름 '원소', '선조', '영혼'이 기본적으로 존재합니다.
-'/간단술사 저장 원소', '/간단술사 저장 선조', '/간단술사 저장 영혼'으로 각 세트의 토템 조합을 변경하여 다시 저장할 수 있습니다.
- '원소', '선조', '영혼' 세트는 삭제할 수 없습니다.
- 원소/선조/영혼 세트를 저장하거나 불러올 때
해당 세트의 네 속성 토템 조합을 한 번에 설치하는 호출 주문용 'MSSC' 매크로도 생성/갱신합니다.
- 일반 사용자 토템 세트는 기존 방식대로 저장,
불러오기, 삭제할 수 있습니다.

■ 토템의 귀환 버튼, 토템 세트 및 UI 토글 버튼(톱니바퀴)
- 기존 토템의 부름 버튼은 Forever의 '토템의 귀환'으로 변경되었습니다.
- 토템의 귀환을 미습득한 경우에는 툴팁에 (미습득)이 표시됩니다.
- 토템 세트 설정: 다양한 상황에 맞는 토템 세트를 저장, 불러오기, 삭제할 수 있습니다.
- 원소, 선조, 영혼 세트는 Forever의 부름 주문에 대응하는 고정 세트이므로 삭제할
수 없습니다.
- 토템 세트 플라이아웃 버튼: 버튼에 마우스오버를 해서 저장된 토템 세트를 간편하게 선택하여 설정합니다.
- 이동 잠금/해제 토글: 우클릭으로 해제하고 두 버튼 바나 연녹색 테두리를 드래그한 다음에 다시 우클릭으로 잠급니다.
- 순환식 크기 토글: Shift+우클릭으로 36픽셀부터 60픽셀까지 8픽셀 단위로 확대합니다. 60픽셀에서 한번 더 클릭하면 36픽셀로 돌아옵니다.

■ 토템 속성 순서
- 설정 창에서 토템 버튼의 속성 순서를 변경할 수 있습니다. 변경시 기존의 토템 세트는 초기화됩니다.

■ 버프 및 소모품 추적기
- 보호막: 자신에게 걸려 있는 보호막의 중첩 수,
지속시간을 표시합니다.
- 윤회 및 십자가: 윤회 스킬의 쿨다운과 현재
가방에 보유 중인 십자가 개수를 표시합니다.
- 수면 걷기/수중 호흡: 아이콘 및 재료 개수를 표시합니다.
- 최신 Forever API에서 제공하는 Aura 정보를
이용하여 보호막 및 버프 상태를 추적합니다.

■ 주요 쿨다운 스킬
- 성난 해일, 용암 폭발, 정기의 깨달음, 선견자의 분노, 자연의 신속함, 마나 해일 토템, 영혼의 귀환, 토템의 귀환, 토템 재배치
등의 주요 스킬을 추적하고 지속시간과 쿨다운을 표시합니다.
- 기존의 대지의 정령 토템 및 불의 정령 토템 버튼은 각각 성난 해일 및 용암 폭발로
변경되었습니다.
- 기존의 주술의 분노는 Forever의 선견자의 분노로 변경되었습니다.
- 기존의 피의 욕망/영웅심 버튼은 Forever의 토템 재배치로 변경되었습니다.
- 기존의 토템의 부름 버튼은 Forever의 토템의 귀환으로 변경되었습니다.

■ 쿨다운 및 상태: 개인 채팅 및 경보음
- 쿨다운 알림: 주요 스킬의 쿨다운 종료 10초 전과 종료 시점에 화면 중앙에 색상별 메시지를 출력합니다.
- 성난 해일과 용암 폭발도 스킬 쿨다운 알림 대상으로 추가되었습니다.
- 선견자의 분노, 자연의 신속함, 마나 해일 토템, 속박의 토템, 마법흡수 토템, 불꽃 회오리 토템, 충격류, 폭풍의 일격 등의 상태 및 쿨다운 알림을 지원합니다.
- 기존의 주술의 분노 관련 알림은 모두 선견자의 분노로 변경되었습니다.
- 상태 알림: 자신에게 보호막이 없을 때, 자신에게 번개 또는 물 보호막이 있는데도 아군에게 대지의 보호막을 시전하지 않았을 때,
무기 버프 지속시간이 부족할 때, 정기의 집중이 발동될 때 메시지를 출력합니다.
- 소용돌이치는 무기: 5중첩이 되었을 때 알림을 출력하며, 5중첩 상태에서 지속시간이 갱신되면 메시지도 갱신됩니다. 지속시간이 끝나거나 소모되어 5중첩 상태가 사라지면 알림도 즉시 제거됩니다.
- 출력 방식을 화면 중앙 메시지 및 경보음을 재생하는 ON(RW), 화면 중앙 메시지만 출력하는 ON 중에서 선택하거나 OFF로 비활성화할 수 있습니다. OFF를 선택하면 각 개인 채팅 체크박스의 선택 여부와 상관없이 모두 비활성화합니다.
- RW 경보음: 재생 여부 및 파일 선택이 가능합니다. 본 애드온 폴더 안에 원하는 ogg
확장자 파일을 MSS_RW.ogg로 저장하면 해당 파일을 경보음으로 사용하고, 그렇지 않다면 RaidWarning.ogg를 재생합니다.

───────────────────────────── 
3. 명령어 및 사용 방법
───────────────────────────── 
■ 기본 명령어
- /간단술사 또는 /mss : 설정 창 열기

■ 토템 세트 설정
- /간단술사 저장 [세트 이름]: 토템 세트 저장
- /간단술사 [세트 이름]: 토템 세트 불러오기 (또는 중간의 톱니바퀴 버튼)
- /간단술사 삭제 [세트 이름]: 토템 세트 삭제 - '원소', '선조', '영혼'은 Forever의 고정 세트 이름으로 기본 생성되어 있으며 삭제할 수 없습니다.
- /간단술사 저장 원소: 현재 토템 조합을 원소의 부름 세트로 저장
- /간단술사 저장 선조: 현재 토템 조합을 선조의 부름 세트로 저장
- /간단술사 저장 영혼: 현재 토템 조합을 영혼의 부름 세트로 저장

■ 이동 잠금/해제 및 크기 변경 - 토템 세트 버튼(톱니바퀴)을 우클릭해서 이동 잠금/해제를, Shift+우클릭해서 크기를 토글합니다.

───────────────────────────── 
4. 설치 방법 ─────────────────────────────
■ 아래와 같은 폴더 구조로 설치하세요. Interface 
└── AddOns
    └── MySimpleShaman
        ├── MySimpleShaman.lua
        ├── MySimpleShaman.toc
        ├── README.txt
        └── MSS_RW.ogg (선택 사항 - 커스텀 경보음)

■ 게임 내 '애드온' 탭에서 [My Simple Shaman]이 활성화되어 있는지
확인합니다.

───────────────────────────── 
5. 주의사항 ─────────────────────────────
■ 주술사 전용: 이 애드온은 주술사 이외의 직업으로 접속하면 동작하지 않습니다.

■ 이동 상태 제한: UI 이동 잠금이 해제된 상태(연녹색 테두리 표시)에서는 토템 설치나 무기 버프 부여가 작동하지 않으므로, 위치 설정 후 반드시 다시 잠가주시기 바랍니다.

■ 매크로 슬롯: 자동 매크로 생성 기능을 사용하려면 공용 매크로 탭에 최소 두 칸의 여유 공간이 있어야 합니다. MSS와 MSSC가 각각 사용하는 매크로를 갱신할 수 있어야 합니다.

■ 토템 세트 이름은 1~2글자로 할 것을 권장합니다. 전투 중에는 토템 세트를 불러올 수 없습니다.

■ '원소', '선조', '영혼'은 Forever의 부름 주문과 연결된 고정 세트 이름이며 삭제할 수 없습니다. 다른 세트 이름은 기존처럼 삭제할 수
있습니다.

■ 토템 속성 순서를 변경하면 기존의 토템 세트가 초기화됩니다.

■ 상태/쿨다운 알림에서 RW는 본인에게만 적용됩니다.

───────────────────────────── 
6. 변경 이력 ─────────────────────────────
■ 1.0.0 (2026. 11. 8.)
 - 토템 세트 설정/저장/불러오기/삭제/자동 매크로 생성
 - 토템, 보호막, 무기 강화, 윤회, 발동 버프, 종족 특성을 포함한 쿨다운 스킬을 추적하고 개인 채팅 및 경보음으로 알림
 - 토템 버프를 받고 있는 대상을 표시
 - 주무기/보조무기 버프, 토템 재배치, 토템의 귀환, 특성별 쿨다운 스킬
 - 이동 잠금/해제 토글 (우클릭)
 - 순환식 크기 토글 (Shift+우클릭)

───────────────────────────── 
7. 저작권 및 이용 조건
───────────────────────────── 
■ 개인 목적에 한해 자유롭게 사용 가능

■ 개발자 표기

■ 상업적 이용 및 무단 전재/재배포 금지

───────────────────────────── 
8. 개발자 정보
───────────────────────────── 
■ Author: Goyathlay, 20주년 기념일
펜구스의 흉포 KR 호드 / Goyathlay Ndee, 포에버 PVP KR 호드

■ Contact: 인게임 우편/디스코드
